Chuyển tới nội dung chính

Gửi yêu cầu PUT (http.put)

Khai báo​

mã trạng thái HTTP, văn bản JSON của header phản hồi, nội dung phản hồi = http.put(URL [, thời gian chờ tính bằng giây, header yêu cầu, dữ liệu nội dung yêu cầu, không escape URL ])

Khai báo (đối số có tên)​

Hỗ trợ từ phiên bản 20250625; các tùy chọn tiến trình được hỗ trợ từ phiên bản 20260402

mã trạng thái HTTP, văn bản JSON của header phản hồi, nội dung phản hồi = http.put{
url = URL;
timeout = thời gian chờ tính bằng giây;
headers = header yêu cầu;
params = tham số query;

-- các tham số nội dung yêu cầu sau không thể cùng tồn tại; thứ tự ưu tiên là multipart > data > json > upload_file
multipart = biểu mẫu multipart trong nội dung yêu cầu;
data = dữ liệu nội dung yêu cầu;
json = JSON trong nội dung yêu cầu;
upload_file = đường dẫn tệp tải lên trong nội dung yêu cầu;

download_file = đường dẫn lưu nội dung phản hồi khi yêu cầu thành công;
progress = hàm gọi lại tiến độ;
progress_interval_ms = khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây;
}

Tham số​

  • URL
    Kiểu chuỗi. URL yêu cầu. Hàm mặc định escape URL; xem không escape URL nếu không muốn xử lý này.
  • thời gian chờ tính bằng giây
    Kiểu số, không bắt buộc. Thời gian chờ tính bằng giây. Mặc định: 10.
  • header yêu cầu
    Kiểu bảng, không bắt buộc. Header yêu cầu có dạng { field1 = value1, ... }. Mặc định: {}.
  • tham số query
    Kiểu bảng, không bắt buộc. Tham số chuỗi truy vấn có dạng { field1 = value1, ... }. Mặc định: {}.
  • dữ liệu nội dung yêu cầu
    Kiểu chuỗi hoặc bảng, không bắt buộc. Nội dung yêu cầu. Mặc định: chuỗi rỗng.
    Từ phiên bản 20250625, nếu truyền bảng thì bảng sẽ được mã hóa theo application/x-www-form-urlencoded.
  • biểu mẫu multipart trong nội dung yêu cầu
    Kiểu bảng, không bắt buộc. Dữ liệu biểu mẫu multipart cần gửi. Mặc định: {}.
  • JSON trong nội dung yêu cầu
    Kiểu bảng, không bắt buộc. Nội dung được mã hóa theo application/json.
  • đường dẫn tệp tải lên trong nội dung yêu cầu
    Kiểu chuỗi, không bắt buộc. Gửi trực tiếp nội dung tệp làm nội dung yêu cầu.
  • đường dẫn lưu nội dung phản hồi khi yêu cầu thành công
    Kiểu chuỗi, không bắt buộc. Nếu được cung cấp và yêu cầu thành công, nội dung phản hồi trả về là đường dẫn tệp đã lưu.
  • hàm gọi lại tiến độ
    Kiểu hàm, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Được gọi khi tiến trình tải lên hoặc tải xuống thay đổi; đối số đầu tiên là thông tin tiến trình hiện tại.
  • khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây
    Kiểu số nguyên, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Khoảng thời gian giữa các lần gọi lại tiến độ, tính bằng mili giây.
  • không escape URL
    Kiểu boolean, không bắt buộc. true = không escape URL. Mặc định: false.
    Để tự escape, hãy xem mô-đun lcurl, easy:escape và easy:unescape.

Giá trị trả về​

  • mã trạng thái HTTP
    Kiểu số nguyên. Mã trạng thái HTTP; trả về -1 khi hết thời gian chờ.
  • văn bản JSON của header phản hồi
    Kiểu chuỗi hoặc nil. Header phản hồi ở định dạng JSON; trả về nil khi hết thời gian chờ.
  • nội dung phản hồi
    Kiểu chuỗi hoặc nil. Nội dung phản hồi; nếu đã lưu vào tệp thì đây là đường dẫn tệp. Trả về nil khi hết thời gian chờ.

Mô tả​

Dùng phương thức PUT của HTTP/1.1 để gửi dữ liệu; cách dùng tương tự POST.
Hàm này có thể nhường quyền thực thi; các luồng khác có thể được chạy trước khi hàm trả về.

Bảng info được truyền cho hàm gọi lại tiến độ có cấu trúc như sau:

{
count_of_bytes_sent = bytes_sent;
count_of_bytes_expected_to_send = bytes_expected_to_send;
count_of_bytes_received = bytes_received;
count_of_bytes_expected_to_receive = bytes_expected_to_receive;
}

Ví dụ​

local code, res_headers, body = http.put("https://httpbin.org/put?hello=world&你好=世界", 15, {
["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)",
["Cookie"] = "a=1; b=2; c=3";
}, "dữ liệu cần gửi")
if code == 200 then
sys.alert(body)
end

Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.

Ví dụ (đối số có tên)​

local code, res_headers, body = http.put{
url = "https://httpbin.org/put";
timeout = 15;
headers = {
["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)";
["Cookie"] = "a=1; b=2; c=3";
};
params = {
["hello"] = "world";
["你好"] = "世界";
};
data = "dữ liệu cần gửi";
}
if code == 200 then
sys.alert(body)
end

Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.